home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / tmkffs17.zip / MANUAL.DOC next >
Text File  |  1991-10-21  |  56KB  |  1,981 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                       TMakeFFSTMakeFFS
  24.  
  25.                            "Turbo Make Fast File System"                           "Turbo Make Fast File System"
  26.  
  27.                                     version 1.07version 1.07
  28.  
  29.                             CPCUG Authorization PendingCPCUG Authorization Pending
  30.  
  31.  
  32.  
  33.  
  34.                              JONCO Systems and Software
  35.                                   P.O. Box 823073
  36.                                  Dallas, Tx. 75382
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                    (C) Copyright 1991, JONCO Systems and Software
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                    ContentsContents
  70.  
  71.  
  72.  
  73.            License Agreement and Limited Warranty                      1
  74.               License Agreement  . . . . . . . . . . . . . . . . . . . 1
  75.               Limited Warranty and Disclaimer of Liability . . . . . . 1
  76.  
  77.            Registration                                                3
  78.               Various Levels . . . . . . . . . . . . . . . . . . . . . 3
  79.                  Unregistered Evaluation . . . . . . . . . . . . . . . 3
  80.                  NOT FOR PROFIT BBS  . . . . . . . . . . . . . . . . . 3
  81.                  Standard Noncommercial Registration . . . . . . . . . 4
  82.                  Commercial Registration . . . . . . . . . . . . . . . 4
  83.               How to Register  . . . . . . . . . . . . . . . . . . . . 4
  84.  
  85.            Chapter 1  Introduction                                     5
  86.               1.1  Purpose . . . . . . . . . . . . . . . . . . . . . . 5
  87.               1.2  Performance . . . . . . . . . . . . . . . . . . . . 6
  88.               1.3  Intelligence  . . . . . . . . . . . . . . . . . . . 6
  89.               1.4  Options . . . . . . . . . . . . . . . . . . . . . . 6
  90.               1.5  Limitations . . . . . . . . . . . . . . . . . . . . 7
  91.  
  92.            Chapter 2  Quick Start "QSetup.Exe"                         9
  93.               2.1  For those who don't like to read Manuals  . . . . . 9
  94.  
  95.            Chapter 3  Option Switches                                 11
  96.               3.1  Environment variables . . . . . . . . . . . . . .  11
  97.                  3.1.1  Video  . . . . . . . . . . . . . . . . . . .  11
  98.                  3.1.2  Overrides  . . . . . . . . . . . . . . . . .  11
  99.               3.2  Command Line Options  . . . . . . . . . . . . . .  12
  100.                  3.2.1  Video, /vxxxx  . . . . . . . . . . . . . . .  12
  101.                  3.2.2  EMS /xNNNNN  . . . . . . . . . . . . . . . .  12
  102.                  3.2.3  Alternate Initialization File  . . . . . . .  13
  103.               3.3  Initialization File System Section  . . . . . . .  13
  104.                  3.3.1  Comments and Blank Lines . . . . . . . . . .  13
  105.                  3.3.2  System Section . . . . . . . . . . . . . . .  14
  106.                     3.3.2.1  NOENV . . . . . . . . . . . . . . . . .  14
  107.                     3.3.2.2  CAT . . . . . . . . . . . . . . . . . .  14
  108.                     3.3.2.3  LIDX  . . . . . . . . . . . . . . . . .  14
  109.                     3.3.2.4  LOPT  . . . . . . . . . . . . . . . . .  14
  110.                     3.3.2.5  FIDX  . . . . . . . . . . . . . . . . .  15
  111.                     3.3.2.6  FIDXT . . . . . . . . . . . . . . . . .  15
  112.                     3.3.2.7  FMS . . . . . . . . . . . . . . . . . .  15
  113.                     3.3.2.8  OFFLN . . . . . . . . . . . . . . . . .  15
  114.                     3.3.2.9  LOG . . . . . . . . . . . . . . . . . .  15
  115.                  3.3.3  File Specs Section . . . . . . . . . . . . .  16
  116.                     3.3.3.1  Subdirectories  . . . . . . . . . . . .  16
  117.  
  118.  
  119.  
  120.                                          i
  121.  
  122.  
  123.                     3.3.3.2  Macros  . . . . . . . . . . . . . . . .  16
  124.                     3.3.3.3  Subdirectories w/wild-card's  . . . . .  17
  125.  
  126.            Chapter 4  Utilities - TMkFList                            19
  127.  
  128.            Appendix A  EXAMPLE: TMakeFFS.INI                          23
  129.  
  130.            Appendix B  EXAMPLE: FILE LIST                             25
  131.               B.1  Macro File List . . . . . . . . . . . . . . . . .  25
  132.               B.2  File List Alternate Form of . . . . . . . . . . .  25
  133.  
  134.            Appendix C  Reading the Log File                           27
  135.  
  136.            Appendix D  Error Level Exit Codes                         29
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.                                         ii
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.                       License Agreement and Limited Warranty                      License Agreement and Limited Warranty
  190.  
  191.  
  192.       License Agreement      License Agreement
  193.  
  194.  
  195.            JONCO Systems and Software authorizes you to use the evaluation
  196.       version of software for a period not to exceed 21 days for evaluation
  197.       purposes. After said period of time you must either discontinue use of
  198.       said software or send your registration fee to JONCO Systems. You may
  199.       freely distribute the evaluation version of said software but you may
  200.       not charge any fee to do so, except to recover expenses of
  201.       distrabution. You may not download or transmit the registered version
  202.       of software electronicly (either by direct connection or
  203.       telecommunication transmission) from one computer to another, except as
  204.       may be specifically allowed in using software on a computer local area
  205.       network.
  206.  
  207.  
  208.       Limited Warranty and Disclaimer of Liability      Limited Warranty and Disclaimer of Liability
  209.  
  210.  
  211.            JONCO warrants the physical diskette and physical documentation
  212.       distributed by JONCO (but not diskettes or documentation distributed by
  213.       any other person/company/users group) to be free of defects in material
  214.       or workmanship for a period of sixty days from the purchase date. Do
  215.       not return any product prior to contacting JONCO and obtaining a return
  216.       authorization number. the entire and exclusive liability and remedy for
  217.       breach of this Limited Warranty shall be limited to replacement of
  218.       defective diskette(s) or documentation and shall not include or extend
  219.       to any claim for or right to recover any other damages, including but
  220.       not limited to, loss of profit, data, or use of software, or special,
  221.       incidental, or consequential damages or other similar claims, even if
  222.       JONCO has been specifically advised of the possibility of such damages.
  223.       Because JONCO Systems and Software can not control the use of the
  224.       software or the environment software is used in, JONCO accepts no
  225.       liability for any loss or damage resulting for use of software. In no
  226.       event will JONCO's liability for any damages to you or any other person
  227.       ever exceed the lower of the actual license fee paid to use the
  228.       software or one dollar (US), regardless of any form of claim.
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                    (C) Copyright 1991, JONCO Systems and Software
  241.  
  242.  
  243.                                   AcknowledgmentsAcknowledgments
  244.  
  245.            I wish to thank our beta testers for all their help, feed back,
  246.       constructive criticisms, etc...
  247.  
  248.                                    Charles Reiss
  249.                                    24 Hours a Day
  250.                                     Dallas, Tx.
  251.                                    (214)343-1701
  252.                  (formerly known as "The 24 Hour Ticket    Agency".
  253.                 One of, if not the longest running     24-Hour RBBS
  254.                 systems in the D/FW area!)
  255.  
  256.  
  257.                                      Rick Dale
  258.                                       BG Micro
  259.                                     Garland, Tx.
  260.                             (214)278-1997 (Members only)
  261.                         (214)278-3418 (New Members Welcome)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.       (C) Copyright 1991, JONCO Systems and Software              2
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.                                    RegistrationRegistration
  310.  
  311.  
  312.       Various Levels      Various Levels
  313.  
  314.  
  315.            Registration of TMakeFFS has has more than one level of
  316.       participation. All levels are provided as a SITE LICENSE AGREEMENT. So
  317.       operating multiple nodes of RBBS via a LAN or multitasking environment
  318.       is of no concern, JONCO wants to be fair to you and hopes you will
  319.       reciprocate the favor. Site license agreement authorizes you to use
  320.       TMakeFFS and its other related utilities on any number of systems only
  321.       at the location said license is issued to. You may not give away, sell,
  322.       loan or transmit electronically a registered copy of TMakeFFS in whole
  323.       or in part to any other person and/or system.
  324.  
  325.                 SITE LICENSES ARE NON TRANSFERABLE!!!
  326.  
  327.            If for any reason you should decide not to register, please we
  328.       would like to know why? However if you should fall in love with it and
  329.       we are sure you will, we want to hear from you to!
  330.  
  331.  
  332.       Unregistered Evaluation      Unregistered Evaluation
  333.  
  334.            You may use the evaluation version of TMakeFFS for 21 days while
  335.       you evaluate it's performance, decide before you buy! The 21 day limit
  336.       may only be extended if you mail your registration fee and are
  337.       currently awaiting delivery of a registered copy or NOT-FOR-PROFIT
  338.       LICENSE AGREEMENT!
  339.  
  340.  
  341.       NOT FOR PROFIT BBS      NOT FOR PROFIT BBS
  342.  
  343.            If after the 21 day evaluation period you decide that TMakeFFS
  344.       works for you and you decide to keep it a $7 registration fee is
  345.       required. You will receive a license agreement authorizing you to
  346.       continue use of the evaluation version on your site.
  347.  
  348.            NOTE: If you charge any fee of any kind for membership or access
  349.       to your board YOU ARE NOT A NOT FOR PROFIT BBS! JONCO reserves the
  350.       right to refuse sale of NOT FOR PROFIT BBS license agreements at it's
  351.       own discretion!
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.       (C) Copyright 1991, JONCO Systems and Software              3
  361.  
  362.  
  363.       Standard Noncommercial Registration      Standard Noncommercial Registration
  364.  
  365.            [NON COMMERCIAL BBS]: If after the 21 day evaluation period you
  366.       decide that TMakeFFS works for you and you decide to keep it a $15
  367.       registration fee and $2 shipping and handling is required. At this
  368.       level of participation you will receive a 5 1/4" disk containing the
  369.       complete utility set, a registered copy of TMakeFFS.Exe with your name,
  370.       BBS name, serial number already installed and a printed (POST SCRIPT
  371.       LASER) and bound manual (JONCO will even use good quality paper)!
  372.  
  373.            NOTE: If your BBS is used for/by a business for any business
  374.       function even if said function is incidental to the core business!
  375.       (i.e. Customer/Technical support for products you or your business
  376.       sells and/or distributes, Internal E-Mail systems, Order
  377.       information/taking systems etc...) YOU ARE NOT A NON COMMERCIAL BBS!
  378.  
  379.       NOTE: If you require 3 1/2" disk add an additional $2. (includes both)
  380.  
  381.  
  382.       Commercial Registration      Commercial Registration
  383.  
  384.            [COMMERCIAL BBS]: If after the 21 day evaluation period you decide
  385.       that TMakeFFS works for you and you decide to keep it a $25
  386.       registration fee and $2 shipping and handling is required. You will
  387.       receive all the material described in the Standard registration
  388.       package.
  389.  
  390.       NOTE: If you require 3 1/2" disk add an additional $2. (includes both)
  391.  
  392.  
  393.       How to Register      How to Register
  394.  
  395.  
  396.            Due to the relatively low cost of site licenses for this utility,
  397.       SITE LICENSES ARE NOT TRANSFERABLE! Send your site license registration
  398.       fee plus $2 shipping and handling (Check or Money Order only, payable
  399.       to JONCO Systems and Software) to:
  400.  
  401.                              JONCO Systems and Software
  402.                                   P.O. Box 823073
  403.                                  Dallas, Tx. 75382
  404.  
  405.            Please include the name of your system (BBS), your name, company
  406.       name complete address, and phone numbers (Voice, FAX, BBS# and Data if
  407.       different from BBS# number) so we may support you better in the future
  408.       should it be required, and notify you of any future enhancements in a
  409.       most timely manner.
  410.  
  411.  
  412.       Orders not accompanied with shipping and handling charges will not be      Orders not accompanied with shipping and handling charges will not be
  413.       processed!      processed!
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.       (C) Copyright 1991, JONCO Systems and Software              4
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.                                      Chapter 1Chapter 1
  430.  
  431.                                    IntroductionIntroduction
  432.  
  433.  
  434.       1.1  Purpose      1.1  Purpose
  435.  
  436.  
  437.          At the request of a friend of mine (C. Reiss of 24 Hours a day) I
  438.       wrote this program because of problems he encountered running the
  439.       supplied utils and/or another replacement utility (written in MS-C and
  440.       occasionally trashes the systems interrupt vector table causing the
  441.       system to hang. Both of which always hung on my 286-12/0).
  442.  
  443.       Specified requirements:                 TMakeFFS.Exe
  444.                                               ----------------------
  445.          1) Must be FAST!                     Like a ROCKET!
  446.  
  447.          2) Must run in DV window!            Supports LIM-EMS!
  448.  
  449.          3) Must be see progress msg          Optionally you may turn
  450.             when run remotely, drop to        BIOS CRT writes on!
  451.             DOS!                              (Works with Doorway)
  452.  
  453.          4) Must mark files in FMS that       Change space after date
  454.             are off-line!                     to * if off-line!
  455.  
  456.          5) Must run from batch file!         On error exits with
  457.                                               ErrorLevel > 0
  458.  
  459.                                               Replaces MakeFFS, QSort
  460.                                               and MakeTabs with one
  461.                                               utility!
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.       (C) Copyright 1991, JONCO Systems and Software              5
  481.  
  482.  
  483.       1.2  Performance      1.2  Performance
  484.  
  485.  
  486.          I/O buffering and record locking is done such that transfers (4K/8K)
  487.       are a factor and/or a multiple of a cluster size either bypassing DOS
  488.       buffers or simplifying the calculations required by DOS to simple
  489.       shifts as opposed to multiplication and addition required for the
  490.       record sizes defined by RBBS.
  491.  
  492.          On my 286-12/0 w/28ms drives running MS-DOS 5.0, w/2048K XMS
  493.       allocated to DumbDrive (a.k.a. SmartDrive), searching 300 directory's
  494.       and 3300+ files execution time is a mere 20 seconds (19 seconds W/O
  495.       LOGFILE). One of the beta test sites reported a time of 45 seconds for
  496.       his CD-ROM drive searching 62 directory's and 15200+ files.
  497.  
  498.                      DON'T   BLINK ,   YOU   MIGHT   MISS   IT!
  499.  
  500.  
  501.       1.3  Intelligence      1.3  Intelligence
  502.  
  503.  
  504.          Assuming your FMS file is correctly formatted TMakeFFS will
  505.       automatically determine the size of FMS records (i.e. the length of the
  506.       description field) in your FMS file. TMakeFFS will also search for its
  507.       configuration file looking first in the current default
  508.       drive:\directory, then if running DOS 3.xx or higher it will look in
  509.       the directory where the program was loaded, then all DOS versions 2.xx
  510.       or higher in every directory in the DOS PATH! (This feature may be over
  511.       ridden on the command line)
  512.  
  513.  
  514.       1.4  Options      1.4  Options
  515.  
  516.  
  517.          Default options specified in the configuration file [TMakeFFS.Ini]
  518.       (see sample below) may be overridden with environment variables (i.e.
  519.       <Dos prompt>SET LIDX=Z:\LIDX.DEF)
  520.       NOTE: With registration this feature may be turned off.
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.       (C) Copyright 1991, JONCO Systems and Software              6
  541.  
  542.  
  543.       1.5  Limitations      1.5  Limitations
  544.  
  545.  
  546.          TMakeFFS is limited only by available conventional and/or expanded
  547.       memory (LIM-EMS), the minimum contiguous free available memory required
  548.       to run TMakeFFS is 192K but will use all available memory (below 640K),
  549.       192K is enough with all options enabled for approximately 6 directories
  550.       and/or Macro File List and 3,930 files, the more directories you use
  551.       the fewer files it can handle. On the other extreme 300 directories and
  552.       10,000 files would only require approximately 452K. While 192K + 2M EMS
  553.       would allow approximately 1,300+ directories and 110,208 files!
  554.  
  555.            Approximate Memory Overhead   W/O EMS          W/EMS
  556.  
  557.            LIDX/FIDX/FMS file buffers    ---------- 8K* ----------
  558.            Log file buffer               ---------- 8K** ---------
  559.            Each directory/File List      ---------- 72 bytes -----
  560.            Files in FIDX                 24 bytes ea.   861 p/16K
  561.  
  562.            * Only one of these is allocated at any particular time, allowing
  563.       them to share the same memory address. (FMS actually uses 2 buffers @
  564.       4K each, one read - one write)
  565.  
  566.            ** Static buffer always allocated regardless of option setting!
  567.  
  568.            A future version may optionally use Extended, XMS or disk swapping
  569.       to extend its limitations to infinity, however I have no immediate
  570.       plans to do so.
  571.  
  572.            Record locking is presently only supported on networks that
  573.       support the DOS Byte Level Share type calls (this includes Novell and
  574.       most if not all NetBios compatibles) again in the future this may
  575.       change!
  576.  
  577.            If you require any modifications let me know, 1) If there is
  578.       sufficient interest in such modifications a future version may
  579.       incorporate them or 2) I will give appropriate consideration to a
  580.       customized version for your specific needs!
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.       (C) Copyright 1991, JONCO Systems and Software              7
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.       (C) Copyright 1991, JONCO Systems and Software              8
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.                                      Chapter 2Chapter 2
  670.  
  671.                              Quick Start "QSetup.Exe"Quick Start "QSetup.Exe"
  672.  
  673.  
  674.       2.1  For those who don't like to read Manuals      2.1  For those who don't like to read Manuals
  675.  
  676.  
  677.            QSetup.Exe takes no parameters of any kind. It may cause some snow
  678.       like effect for brief moments on some older CGA's.
  679.  
  680.            The utility program QSetup.Exe will attempt to create an
  681.       initialization "TMakeFFS.Ini" file for TMakeFFS based on data collected
  682.       from your system  as in paths to FMS.DIR, LIDX.DEF, FIDX.DEF and of
  683.       course the TMakeFFS.Exe. In addition to the paths it will read your
  684.       LIDX file to determine what to insert in your INI file for the
  685.       FILESPECS section. To be perfectly honest QSetup.Exe is very crudely
  686.       written, in fact I'm embarrassed  to admit I wrote it, but is included
  687.       to assist you in getting TMakeFFS up and running for you. I want you to
  688.       evaluate TMakeFFS, and not spend your time figuring out how to make it
  689.       work!
  690.  
  691.            QSetup can not properly handle every possible configuration. Most
  692.       likely the INI file it creates will have to be edited manually! But it
  693.       should prove very useful in reducing the amount of work creating that
  694.       first INI file, and that's all it is intended for!
  695.  
  696.            The INI file is a flat ASCII file any word processor in non-
  697.       document mode can be used to edit it, just keep the line lengths below
  698.       255!
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.       (C) Copyright 1991, JONCO Systems and Software              9
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.       (C) Copyright 1991, JONCO Systems and Software              10
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.                                      Chapter 3Chapter 3
  790.  
  791.                                   Option SwitchesOption Switches
  792.  
  793.  
  794.          Presently there is no switch to turn the progress display off,
  795.       Backup files off (Always renames original files Drive:\Path\Name.[BAK],
  796.       If Drive:\Path\Name.[BAK] already exist it is deleted!)
  797.  
  798.  
  799.       3.1  Environment variables      3.1  Environment variables
  800.  
  801.  
  802.       3.1.1  Video      3.1.1  Video
  803.  
  804.            VIDEO=BIOS     TURNS DIRECT WRITES TO VIDEO RAM OFF
  805.                           program then uses BIOS ROM INT 10h
  806.                           routines to write to and scroll
  807.                           the screen. DEFAULT is VIDEO=FAST.
  808.  
  809.            VIDEO=SNOW     Required for some old CGA's turns
  810.                           CGA Snow checking on.
  811.  
  812.       3.1.2  Overrides      3.1.2  Overrides
  813.  
  814.            LIDX=[DRIVE:][\PATH\][FILENAME][.EXT]
  815.            FIDX=[DRIVE:][\PATH\][FILENAME][.EXT]
  816.            FIDXT=[DRIVE:][\PATH\][FILENAME][.EXT]
  817.            FMS=[DRIVE:][\PATH\][FILENAME][.EXT]
  818.            LOPT=(ON/OFF)
  819.            LOG=[DRIVE:][\PATH\][FILENAME][.EXT]
  820.  
  821.            Where [DRIVE:][PATH\][FILENAME][.EXT] over rides the
  822.       [DRIVE:][\PATH\][FILENAME][.EXT] specified in the INI file.
  823.       (NOTE: THIS FEATURE CAN BE DISABLED IN THE INITIALIZATION FILE!)
  824.  
  825.            See the section "Initialization File System Section" for more
  826.       information on overrides.
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.       (C) Copyright 1991, JONCO Systems and Software              11
  841.  
  842.  
  843.       3.2  Command Line Options      3.2  Command Line Options
  844.  
  845.  
  846.       3.2.1  Video, /vxxxx      3.2.1  Video, /vxxxx
  847.  
  848.          /vxxxx  Controls video writes where xxxx can be (BIOS, FAST, SNOW),
  849.       need not be in caps and you may use only the first letter.
  850.  
  851.            /vBIOS or /vB  TMakeFFS will use bios calls for all
  852.                           video writes.
  853.  
  854.            /vSNOW or /vS  Required for some old CGA's turns
  855.                           CGA Snow checking on.
  856.  
  857.            /vFAST or /vF  Turns Bios video writes off DEFAULT,
  858.                           overrides environment variable
  859.                           restoring the default.
  860.  
  861.            NOTE: Setting the video mode either in the environment or by
  862.            the command line options to anything other than the default
  863.            can seriously impede performance!
  864.  
  865.         TMakeFFS fully supports 43/50 line EGA/VGA text modes, further than
  866.       that it should support any text mode your video card can muster up it
  867.       works just fine on my vga card at 132X60 using all 60 lines, although
  868.       the characters are a bit small and a little difficult to read!
  869.       (TMakeFFS actually never uses the last two lines in any mode!) TMakeFFS
  870.       uses the video mode that is active when it loads, it never changes
  871.       video modes!
  872.  
  873.  
  874.       3.2.2  EMS /xNNNNN      3.2.2  EMS /xNNNNN
  875.  
  876.            /xNNNNN Controls amount of expanded memory to allocate, where
  877.       NNNNN is the number of Kbytes to allocate. Regardless of EMS version
  878.       /x0 or /x w/o value turns use of expanded memory completely off, the
  879.       default is ON. TMakeFFS only EMS to store and sort information about
  880.       files, not subdirectories!
  881.  
  882.            With LIM-EMS 3.2 TMakeFFS defaults to using all available memory
  883.       with this switch you may limit the maximum it uses.
  884.  
  885.            With LIM-EMS 4.0 TMakeFFS defaults to 16K and allocates more as it
  886.       is needed. The /x switch maybe used in this case to reserve (i.e.
  887.       preallocates) an amount of memory for TMakeFFS to use. With EMS 4.0
  888.       TMakeFFS will always try to extend it's allocation of expanded memory
  889.       by 16K before it fails!
  890.            Expanded memory requirements may be calculated as:
  891.  
  892.       KBytes = ((([MAX. Number Files] + 860) DIV 861) + 1) * 16
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.       (C) Copyright 1991, JONCO Systems and Software              12
  901.  
  902.  
  903.       NOTE: Memory permitting a substantial performance improvement may be
  904.       gained by turning EMS usage OFF! Use of EMS memory degrades performance
  905.       20-50% on various systems, this has proven in testing to be largely due
  906.       to the overhead of the EMS driver. I will now admit to having actually
  907.       used Borlands Turbo Profiler. Hey there's a first time for everything!
  908.       I honestly didn't think it was anything I did, just had to make sure
  909.       (Excluding DOS calls the slowest instruction proved to be the EMM call,
  910.       INT 67h!) Different EMS drivers and/or hardware from various vendors
  911.       will no doubt give various results.
  912.  
  913.  
  914.       3.2.3  Alternate Initialization File      3.2.3  Alternate Initialization File
  915.  
  916.         You may also specify the Drive:\Path\FileName.Ext of the
  917.       initialization file any where on the command line....
  918.  
  919.       EXAMPLE #1
  920.       D:\RBBS > D:\RBBS\UTIL\TMakeFFS /vF [Drive:\Path\FileName.Ext]
  921.  
  922.       EXAMPLE #2
  923.       D:\RBBS > D:\RBBS\UTIL\TMakeFFS [Drive:\Path\FileName.Ext] /vF
  924.  
  925.       EXAMPLE #3
  926.       D:\RBBS > D:\RBBS\UTIL\TMakeFFS C:\Board1\TMakeFFS.Ini
  927.  
  928.         If only the path is specified then the default drive and file name
  929.       TMakeFFS.Ini is used, if only the drive is specified (C:FileName.Ext)
  930.       then the default directory on that drive is used.
  931.  
  932.            NOTE: The TMakeFFS attempts to open the initialization file Read-
  933.       Only Deny-Write access for network compatibility.
  934.  
  935.  
  936.       3.3  Initialization File System Section      3.3  Initialization File System Section
  937.  
  938.  
  939.            The TMakeFFS initialization file is a flat ASCII text file, anyone
  940.       familiar with MS-Windows INI files will see a number of similarities!
  941.       Any text editor in NON-DOCUMENT mode will be sufficient for editing.
  942.       The rules are few and simple, all commands enclosed in brackets must be
  943.       in upper-case! You may include blank lines and comments almost anywhere
  944.       in the file.
  945.  
  946.       3.3.1  Comments and Blank Lines      3.3.1  Comments and Blank Lines
  947.  
  948.            Comments are defined as any text following a semicolon ";". For
  949.       example If you wanted to embed printer control codes you could
  950.       immediately following the [TFMS_SYSTEM] (See System Section) place
  951.       ";control codes"
  952.  
  953.       Example:
  954.       [TFMS_SYSTEM];(codes for printer to do compressed print)
  955.  
  956.  
  957.  
  958.  
  959.  
  960.       (C) Copyright 1991, JONCO Systems and Software              13
  961.  
  962.  
  963.            Blank lines may be inserted any where in the initialization file
  964.       after the first line!
  965.  
  966.       3.3.2  System Section      3.3.2  System Section
  967.  
  968.            First up the first line must contain the text "[TFMS_SYSTEM]"
  969.       (Must include the brackets) with out any leading characters, may
  970.       however be followed with a comment. It is in this section you tell
  971.       TMakeFFS where to find files it needs and where to put the files it
  972.       builds. TMakeFFS stops processing a line when it reaches the end of
  973.       line (of course) or a comment!
  974.  
  975.       3.3.2.1  NOENV      3.3.2.1  NOENV
  976.  
  977.       NOENV
  978.            Turns all environment variable overrides off (Except Video)! This
  979.       option can be located anywhere in the system section! The default is
  980.       allow overrides.
  981.  
  982.       NOTE: Evaluation version ignores this option!
  983.  
  984.       3.3.2.2  CAT      3.3.2.2  CAT
  985.  
  986.       CAT=[Drive:][\Path\][FileName][.Ext]
  987.            Specifies location of CAT.DIR file. Not currently used by TMakeFFS
  988.       but may be used by another utility program in the future!
  989.  
  990.       3.3.2.3  LIDX      3.3.2.3  LIDX
  991.  
  992.       LIDX=[Drive:][\Path\][FileName][.Ext]
  993.            Specifies location of LIDX.DEF file. This parameter may be
  994.       overridden by environment variable, unless NOENV option is set!
  995.  
  996.       NOTE: LIDX file location must be specified somewhere in order for
  997.       TMakeFFS to do it's job!
  998.  
  999.       3.3.2.4  LOPT      3.3.2.4  LOPT
  1000.  
  1001.       LOPT=(ON/OFF)
  1002.            This option if set ON instructs TMakeFFS to create the smallest
  1003.       possible LIDX file. Firstly it does not create an LIDX record for
  1004.       subdirectories that contain no files (Possibly your upload directory).
  1005.       Secondly especially useful if file list are used it attempts to match
  1006.       the specified macro/subdirectory with an already defined LIDX record!
  1007.       (See FileSpecs and wild-cards!) The default for this option is OFF!
  1008.       This parameter may be overridden by environment variable, unless NOENV
  1009.       option is set!
  1010.  
  1011.       NOTE: Evaluation version ignores this option!
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.       (C) Copyright 1991, JONCO Systems and Software              14
  1021.  
  1022.  
  1023.       3.3.2.5  FIDX      3.3.2.5  FIDX
  1024.  
  1025.       FIDX=[Drive:][\Path\][FileName][.Ext]
  1026.            Specifies location of FIDX.DEF file. This parameter may be
  1027.       overridden by environment variable, unless NOENV option is set!
  1028.  
  1029.       NOTE: FIDX file location must be specified somewhere in order for
  1030.       TMakeFFS to do it's job!
  1031.  
  1032.       3.3.2.6  FIDXT      3.3.2.6  FIDXT
  1033.  
  1034.       FIDXT=[Drive:][\Path\][FileName][.Ext]
  1035.            Optionally specifies location of optional FIDXT.DEF file. The only
  1036.       time I can see that you wouldn't want to use this option is if you have
  1037.       more than 65535 files in your FIDX.DEF file, since the definition by
  1038.       RBBS is an array of word size pointers the limits are 0..65535 and
  1039.       apparently RBBS does not use zero! This parameter may be overridden by
  1040.       environment variable, unless NOENV option is set!
  1041.  
  1042.       3.3.2.7  FMS      3.3.2.7  FMS
  1043.  
  1044.       FMS=[Drive:][\Path\][FileName][.Ext] of FMS.DIR file.
  1045.            Optionally specifies location of FMS.DIR file. This is optional to
  1046.       TMakeFFS. If specified however TMakeFFS will scan the FMS.DIR file and
  1047.       any files it chains to, and verify that all files listed are available
  1048.       in the file specs given. If the file listed in the FMS.DIR file cannot
  1049.       be found TMakeFFS will place an asterisk immediately following the date
  1050.       (See also OFFLN and LOG). If a file was previously missing and is now
  1051.       present TMakeFFS will change the asterisk back to a space. This
  1052.       parameter may be overridden by environment variable, unless NOENV
  1053.       option is set!
  1054.  
  1055.       3.3.2.8  OFFLN      3.3.2.8  OFFLN
  1056.  
  1057.       OFFLN=[Drive:][\Path\][FileName][.Ext] of  file.
  1058.            Optionally specifies a macro file to associate with any files
  1059.       found to be missing from the FMS.DIR file! If specified any files that
  1060.       are found to be off-line are added to FIDX.DEF file with it's location
  1061.       being the macro file!
  1062.  
  1063.       3.3.2.9  LOG      3.3.2.9  LOG
  1064.  
  1065.       LOG=[Drive:][\Path\][FileName][.Ext] of log file.
  1066.            Optionally specifies a log file to create. If specified a VERY
  1067.       DETAILED log file is created! If FMS is specified will contain in it's
  1068.       [FMS] section a list of files that are off-line and in it's [FIDX]
  1069.       section it will contain a list of files that are missing from the
  1070.       FMS.DIR file (in FIDX order). See Chapter on Reading the Log File for
  1071.       more details! This parameter may be overridden by environment variable,
  1072.       unless NOENV option is set!
  1073.  
  1074.       NOTE: Evaluation version ignores this option!
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.       (C) Copyright 1991, JONCO Systems and Software              15
  1081.  
  1082.  
  1083.       3.3.3  File Specs Section      3.3.3  File Specs Section
  1084.  
  1085.            In this section denoted by the command "[FILESPECS]" you are
  1086.       telling TMakeFFS where to search for files while building the FIDX.DEF
  1087.       file. TMakeFFS supports macros embedded in a list of files and also
  1088.       indirectly supports file name wild-card's (See alternate form file
  1089.       list).
  1090.  
  1091.       3.3.3.1  Subdirectories      3.3.3.1  Subdirectories
  1092.  
  1093.            In order to instruct TMakeFFS to include all files in a given
  1094.       subdirectory you simply give it the [Drive:][\Path\] to search for
  1095.       files. Special note: THIS PATH MUST BE TERMINATED WITH A "\" (Wild-
  1096.       cards are not permited!)
  1097.  
  1098.       EXAMPLES:
  1099.  
  1100.       C:\TP\
  1101.       C:\TP\RTL\
  1102.  
  1103.            These would include all files in the subdirectories C:\TP\ and
  1104.       C:\TP\RTL\, simple right!
  1105.  
  1106.       3.3.3.2  Macros      3.3.3.2  Macros
  1107.  
  1108.            The implementation of macro's is easy to setup and maintain
  1109.       especially with the added utility TMkFList, discussed in detail in a
  1110.       later chapter. Basically instead of [Drive:][\Path\] used to search
  1111.       subdirectories you insert M!=[Drive:][\Path\][FileName][.Ext] of a list
  1112.       of files whose first line contains "M!
  1113.       [Drive:][\Path\][FileName][.Ext]" where
  1114.       [Drive:][\Path\][FileName][.Ext] is the Drive:\Path\FileName.Ext of the
  1115.       macro to execute for up/downloads!
  1116.  
  1117.            For example if the initialization file contained the following
  1118.       line. NOTE: The use of the "=" in the initialization file.
  1119.  
  1120.       M!=C:\Tp\Source\TMakeFFS\FileList.Dat
  1121.  
  1122.       and C:\Tp\Source\TMakeFFS\FileList.Dat contained the following text.
  1123.       NOTE: The absence of the "=" in the file list, there must be a space
  1124.       following the "M!", further note that the file list MAY NOT CONTAIN ANY
  1125.       BLANK LINES OR COMMENTS, THE LIST OF FILES MAY NOT CONTAIN ANY DRIVE
  1126.       AND/OR DIRECTORY SPECIFIERS EITHER! (NO WILD-CARD'S ALLOWED)
  1127.  
  1128.       M! C:\RBBS\BUG_OFF.MCR
  1129.       GORILLA.BAS
  1130.       MONEY.BAS
  1131.       NIBBLES.BAS
  1132.       REMLINE.BAS
  1133.       ASSIGN.COM
  1134.       COMMAND.COM
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.       (C) Copyright 1991, JONCO Systems and Software              16
  1141.  
  1142.  
  1143.       TMakeFFS would open the file C:\Tp\Source\TMakeFFS\FileList.Dat and
  1144.       read in the first line "M! C:\RBBS\BUG_OFF.MCR", make an LIDX record
  1145.       for that line and then proceed to read the rest of the file attaching
  1146.       the macro defined by the first line to all file names in the rest of
  1147.       the list. So if someone called your system and tried to upload a file
  1148.       "COMMAND.COM" RBBS would execute the macro "C:\RBBS\BUG_OFF.MCR" and in
  1149.       this particular example if it was my system that macro would log them
  1150.       off immediately and eighty-six their ability to ever log on again (i.e.
  1151.       lifetime ban from system)! However other examples might just retrieve
  1152.       the file from a tape drive (i.e. download request) or tell the caller
  1153.       you don't want that particular file (i.e. upload request)!
  1154.  
  1155.       3.3.3.3  Subdirectories w/wild-card's      3.3.3.3  Subdirectories w/wild-card's
  1156.  
  1157.            TMakeFFS DOES NOT DIRECTLY implement the use of wild-cards for
  1158.       file searches! It does support a variation of a macro file list that
  1159.       can be implemented in such a way as to emulate the use of wild-card's.
  1160.       The distinguishing characteristic is the first line of the file list,
  1161.       see example below.
  1162.  
  1163.       D! C:\DOS5\
  1164.       GORILLA.BAS
  1165.       MONEY.BAS
  1166.       NIBBLES.BAS
  1167.       REMLINE.BAS
  1168.       ASSIGN.COM
  1169.       COMMAND.COM
  1170.  
  1171.            Did you spot the difference? Note in the prior example on macro's
  1172.       the first line started with "M! ". Here the "D! " tells TMakeFFS to
  1173.       attach files in the list to the directory "C:\DOS5\" as if the
  1174.       initialization file itself had the entry "C:\DOS5\" with the exception
  1175.       that only the files in the list are added to the FIDX.DEF file
  1176.       (TMakeFFS does not check if the file really exist in the specified
  1177.       directory) as opposed to all files in the directory if "C:\DOS5" were
  1178.       specified in the initialization file! I know your thinking "Well this
  1179.       isn't going to be easy to maintain!", but it is! TMkFList.Exe will make
  1180.       both forms of file list for you and YES, IT DOES ACCEPT WILD-CARD'S, so
  1181.       be sure you read the chapter on "Utilities - TMkFList"!
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.       (C) Copyright 1991, JONCO Systems and Software              17
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.       (C) Copyright 1991, JONCO Systems and Software              18
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.                                      Chapter 4Chapter 4
  1270.  
  1271.                                Utilities - TMkFListUtilities - TMkFList
  1272.  
  1273.  
  1274.       TMkFList, "Turbo Make File List" version 1.01
  1275.       (C) Copyright 1991, JONCO Systems and Software
  1276.  
  1277.         To facilitate the building and/or rebuilding of file list used in the
  1278.       construction of the FMS Fast File System, you may need to use the
  1279.       supplied utility program TMkFList.Exe. No secrets or tricks to this one
  1280.       its really quite straight forward. Firstly no configuration file is
  1281.       needed its controlled completely by the command line and requires a
  1282.       minimum of four parameters.
  1283.  
  1284.       TMkFList [File_List] [Macro] [Path] [FileSpec] ([FileSpec]...)
  1285.  
  1286.        Where: [File_List]   is complete Drive:\Path\FileName.Ext of file
  1287.                             list to create.
  1288.  
  1289.               [Macro]       is complete Drive:\Path\FileName.Ext of
  1290.                             MACRO file to embed in file list.
  1291.                             You may also use an option here /d
  1292.                             This option forces the file list to embed
  1293.                             the directory name as D! instead of a macro
  1294.                             file name M!
  1295.  
  1296.               [Path]        is complete Drive:\Path\ to search for
  1297.                             files.
  1298.  
  1299.               [FileSpec]    is the search spec used for files (*.Bat
  1300.                             *.Zip).
  1301.  
  1302.       *** If Drive and/or Path is omitted the default drive and/or ***
  1303.       *** path is used (if the default for D: is games and you     ***
  1304.       *** specified D:. for the search directory then all files    ***
  1305.       *** matching D:\GAMES\*.Zip would be added to the list)      ***
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.       (C) Copyright 1991, JONCO Systems and Software              19
  1321.  
  1322.  
  1323.       EXAMPLE:
  1324.  
  1325.         If Default drive is C: and the directory \TEMP\ and Drive D: was
  1326.       D:\MACRO then:
  1327.  
  1328.         TMkFList ALIST.MCR D:LIMIT.MCR \DOS *.C* *.EXE *.SYS
  1329.  
  1330.         This would create a file C:\TEMP\ALIST.MCR, the first line of the
  1331.       file would be:
  1332.  
  1333.       M! D:\MACRO\LIMIT.MCR
  1334.  
  1335.       ------------- C:\TEMP\ALIST.MCR might look like this ------------
  1336.       M! D:\MACRO\LIMIT.MCR
  1337.       ASSIGN.COM
  1338.       COMMAND.COM
  1339.       DISKCOPY.COM
  1340.       .
  1341.       .
  1342.       ATTRIB.EXE
  1343.       BACKUP.EXE
  1344.       CHKDSK.EXE
  1345.       .
  1346.       .
  1347.       DRIVER.SYS
  1348.       EGA.SYS
  1349.       HIMEM.SYS
  1350.       -----------------------------------------------------------------
  1351.  
  1352.       ALTERNATE FORM:
  1353.  
  1354.         TMkFList BLIST.MCR /D E:\UPLOAD *.ARC *.PAK *.ZIP
  1355.  
  1356.         This would create a file C:\TEMP\BLIST.MCR, the first line of the
  1357.       file would be:
  1358.  
  1359.       D! E:\UPLOAD\
  1360.  
  1361.       ------------- C:\TEMP\BLIST.MCR might look like this ------------
  1362.       D! E:\UPLOAD\
  1363.       4DOS303P.ZIP
  1364.       PDOXTOOL.ARC
  1365.       PDPASCAL.PAK
  1366.       .
  1367.       .
  1368.       TINYC.ARC
  1369.       ABACKUP.PAK
  1370.       EXE2ROM.ZIP
  1371.       -----------------------------------------------------------------
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.       (C) Copyright 1991, JONCO Systems and Software              20
  1381.  
  1382.  
  1383.         The following lines the file would contain all file names in the
  1384.       C:\DOS directory that match the criterion *.C*, *.EXE and *.SYS
  1385.       (special note TMkFList ignores Volume Id, any file with the System
  1386.       Attribute set and ALL Directory Names including current "." and
  1387.       parent ".." ).
  1388.  
  1389.         Assume the TMakeFFS.Ini file contained in the filespec section
  1390.       M!=C:\TEMP\ALIST.MCR in addition to other file list macros, the
  1391.       following batch file less the "comments" I've added maybe appropriate:
  1392.  
  1393.       Echo Off
  1394.  
  1395.       Cd C:\Temp
  1396.  
  1397.       Cd D:\Macro
  1398.  
  1399.       TMkFList ALIST.MCR D:LIMIT.MCR \DOS *.C* *.EXE *.SYS
  1400.  
  1401.       If ErrorLevel == 3 Goto BADDIR  "Directory C:\DOS not found!"
  1402.  
  1403.       If ErrorLevel == 2 Goto IOERR   "Write Fault! Disk maybe full?"
  1404.                                       "or Existing file is Read-Only!"
  1405.  
  1406.       If ErrorLevel == 1 Goto PARAMS  "Parameters at least four required!"
  1407.  
  1408.       TMkFList BLIST.MCR D:GET_LOST.MCR \PRIVATE *.*
  1409.       .
  1410.       .
  1411.       .
  1412.       TMakeFFS
  1413.       .
  1414.       .
  1415.       .
  1416.       :QUIT                           "End of Batch File"
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.       (C) Copyright 1991, JONCO Systems and Software              21
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.       (C) Copyright 1991, JONCO Systems and Software              22
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.                                     Appendix AAppendix A
  1510.  
  1511.                                EXAMPLE: TMakeFFS.INIEXAMPLE: TMakeFFS.INI
  1512.  
  1513.  
  1514.       [TFMS_SYSTEM]               ;This line is required and must be
  1515.                                   ;the first line in the INI file
  1516.                                   ;This file may contain comments just
  1517.                                   ;about anywhere comments are preceded
  1518.                                   ;with a semicolon. Processing of each
  1519.                                   ;line ends on the first white space
  1520.                                   ;char (spaces, tabs) or the beginning
  1521.                                   ;of a comment! Blank lines are OK!!!
  1522.  
  1523.       ;CAT=DIR.CAT                ;CAT= is unused but not illegal
  1524.                                   ;you can use this for your own note
  1525.                                   ;keeping purposes
  1526.  
  1527.       LIDX=G:\LIDX.DEF            ;[DRIVE:\PATH\FILENAME] of LIDX file
  1528.                                   ;this is the only required parameter
  1529.                                   ;in the INI file
  1530.  
  1531.       LOPT=ON                     ;Turns on automatic optimization of
  1532.                                   ;LIDX file. Simply stated that means
  1533.                                   ;that location entries that do not
  1534.                                   ;contain any files are not written
  1535.                                   ;to the LIDX file, thus reducing
  1536.                                   ;the size of the file saving valuable
  1537.                                   ;disk space.
  1538.                                   ;NOTE: Requires registration
  1539.                                   ;activation key.
  1540.  
  1541.       FIDX=G:\FIDX.DEF            ;[DRIVE:\PATH\FILENAME] of FIDX file
  1542.                                   ;If omitted then a new FIDX is not
  1543.                                   ;written!
  1544.  
  1545.       FIDXT=G:\FIDXT.DEF          ;[DRIVE:\PATH\FILENAME] of FIDXT file
  1546.                                   ;If omitted then a new FIDXT is not
  1547.                                   ;written! NOTE: Ignored if FIDX is
  1548.                                   ;not set also!
  1549.  
  1550.       FMS=G:\FMS.DIR              ;[DRIVE:\PATH\FILENAME] of FMS.DIR file
  1551.                                   ;If omitted then a new FIDXT is not
  1552.                                   ;written!
  1553.                                   ;NOTE: Chaining FMS files requires
  1554.                                   ;registration activation key
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.       (C) Copyright 1991, JONCO Systems and Software              23
  1561.  
  1562.  
  1563.       OFFLN=G:\OFFLINE.MCR        ;[DRIVE:\PATH\FILENAME] of MACRO to
  1564.                                   ;Associate with off-line files in FMS
  1565.                                   ;file. If omitted off-line files in
  1566.                                   ;FMS are not added to FIDX.
  1567.                                   ;NOTE: Requires registration
  1568.                                   ;activation key.
  1569.  
  1570.       LOG=G:\TMakeFFS.Log         ;[DRIVE:\PATH\FILENAME] of log file
  1571.                                   ;to write information about duplicate
  1572.                                   ;file names, off-line file names etc.
  1573.                                   ;NOTE: Requires registration
  1574.                                   ;activation key.
  1575.  
  1576.       NOENV                       ;Turns off processing of environment
  1577.                                   ;variable overrides!
  1578.                                   ;NOTE: Requires registration
  1579.                                   ;activation key.
  1580.  
  1581.       [FILESPECS]
  1582.       M!=T:\UNITS\FIDX\FILELIST.DAT
  1583.                                   ;NOTE THE USE OF M!= the = is required
  1584.                                   ;here! SEE EXAMPLE OF FILELIST.DAT
  1585.                                   ;FOLLOWING THIS SECTION
  1586.                                   ;NOTE: Requires registration
  1587.                                   ;activation key.
  1588.  
  1589.       C:\TP\                      ;NOTE: Path must terminate with "\"
  1590.       C:\TP\RTL\                  ;If you need to specify specific files
  1591.       D:\GAMES\                   ;using wild cards you must use a MACRO,
  1592.       D:\ZIP\                     ;see UTIL.DOC for use of TMkFList.Exe
  1593.       E:\PDOX35\
  1594.       E:\QM42\
  1595.       E:\QPRO\
  1596.       E:\SPRINT\
  1597.       E:\WORK\CPU\
  1598.       E:\WORK\EVEREX\
  1599.       E:\WORK\IBM\
  1600.       E:\WORK\USO\
  1601.       F:\BORLANDC\
  1602.       F:\BORLANDC\CRTL\
  1603.       F:\TASM\
  1604.       F:\TD\
  1605.       F:\TPROF\
  1606.       F:\TPW\
  1607.       F:\TPW\RTL\
  1608.       F:\WINDOWS\
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.       (C) Copyright 1991, JONCO Systems and Software              24
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.                                     Appendix BAppendix B
  1630.  
  1631.                                 EXAMPLE: FILE LISTEXAMPLE: FILE LIST
  1632.  
  1633.  
  1634.       B.1  Macro File List      B.1  Macro File List
  1635.  
  1636.  
  1637.            First line must be M![Space][Drive:\Path\FileName.Ext] of the
  1638.       macro to associate with the file names in this list or
  1639.       D![Space][Drive:\Path\] of the directory to associate with the file
  1640.       names in this list. Second and succeeding lines are filespecs, NO BLANK
  1641.       lines are permitted! TMakeFFS does not test if file names are valid
  1642.       file names except that file names must be 12 characters or shorter, if
  1643.       file name is longer than 12 characters it is truncated!
  1644.  
  1645.       -------------- BEGIN OF SAMPLE FILELIST --------------
  1646.       M! UNWANTED.MCR
  1647.       ML.BAT
  1648.       NET.BAT
  1649.       OPATH.BAT
  1650.       ADDPATH.BAT
  1651.       SORTDIR.BAT
  1652.       KC.BAT
  1653.       SPROMPT.BAT
  1654.       LOGIN.BAT
  1655.       TB.BAT
  1656.       LOGOFF.BAT
  1657.       USET.BAT
  1658.       MC.BAT
  1659.       MKARC.BAT
  1660.       ------------------------------------------------------
  1661.  
  1662.  
  1663.       B.2  File List Alternate Form of      B.2  File List Alternate Form of
  1664.  
  1665.  
  1666.          The alternate form of File List allows the you to selectively use
  1667.       subdirectories.
  1668.  
  1669.       ------------- ALTERNATE FORM OF FILELIST -------------
  1670.       D! C:\BAT\
  1671.       ML.BAT
  1672.       NET.BAT
  1673.       OPATH.BAT
  1674.       ADDPATH.BAT
  1675.       SORTDIR.BAT
  1676.       KC.BAT
  1677.  
  1678.  
  1679.  
  1680.       (C) Copyright 1991, JONCO Systems and Software              25
  1681.  
  1682.  
  1683.       SPROMPT.BAT
  1684.       LOGIN.BAT
  1685.       TB.BAT
  1686.       LOGOFF.BAT
  1687.       USET.BAT
  1688.       MC.BAT
  1689.       MKARC.BAT
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.       (C) Copyright 1991, JONCO Systems and Software              26
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.                                     Appendix CAppendix C
  1750.  
  1751.                                Reading the Log FileReading the Log File
  1752.  
  1753.  
  1754.            The following log file example is by no means complete it has been
  1755.       cutup severely. Significant points of interest have been left in, as
  1756.       well as some notes have been added!
  1757.  
  1758.       ------------------- SAMPLE LOG FILE ------------------------
  1759.       TMakeFFS, "Turbo MAKE Fast File System", version 1.07 BETA
  1760.       (C) Copyright 1991, JONCO Systems and Software, P.O.Box 823073
  1761.  
  1762.       Serial#:    BETA TEST     Registered to: UNREGISTERED VERSION
  1763.       BETA TEST VERSION NOT FOR DISTRIBUTION
  1764.  
  1765.       [LOGFILE]
  1766.              LOG FILE:    G:\TMAKEFFS.LOG
  1767.         CREATION DATE:    Thursday October 17, 1991
  1768.                  TIME:    09:41:32 PM
  1769.             INIT FILE:    T:\UNITS\FIDX\TMAKEFFS.INI
  1770.  
  1771.                  LIDX:    G:\LIDX.DEF
  1772.                  LOPT:    ON
  1773.                  FIDX:    G:\FIDX.DEF
  1774.                 FIDXT:    G:\FIDXT.DEF
  1775.                   FMS:    G:\FMS.DIR
  1776.  
  1777.       [LIDX]
  1778.       OFF-LINE:  M! T:\UNITS\FIDX\OFFLINE.MCR                       1
  1779.       Note: This is the LIDX.DEF record number                      ^      Note: This is the LIDX.DEF record number                      ^
  1780.  
  1781.       File List: M!=T:\UNITS\FIDX\FILELIST.MCR
  1782.           MACRO: M! T:\UNITS\FIDX\UNWANTED.MCR                      2
  1783.               26 files added to FIDX.
  1784.  
  1785.       File List: M!=T:\UNITS\FIDX\MACRO.MCR
  1786.           MACRO: M! TRASHEM.MCR                                     3
  1787.                1 files added to FIDX.
  1788.  
  1789.       File List: M!=T:\UNITS\FIDX\AMACRO.MCR
  1790.           MACRO: M! TRASHEM.MCR                                     3
  1791.                1 files added to FIDX.
  1792.       Note: Same MACRO file names, same LIDX.DEF numbers            ^      Note: Same MACRO file names, same LIDX.DEF numbers            ^
  1793.  
  1794.       File List: M!=T:\UNITS\FIDX\AFLIST.MCR
  1795.           MACRO: C:\SYSTEM\                                         4
  1796.               83 files added to FIDX.
  1797.  
  1798.  
  1799.  
  1800.       (C) Copyright 1991, JONCO Systems and Software              27
  1801.  
  1802.  
  1803.       -------------------- EDITED -------------------------------
  1804.       Directory: C:\SYSTEM\                                         4
  1805.            GORILLA.BAS  is in: C:\SYSTEM\
  1806.            MONEY.BAS    is in: C:\SYSTEM\
  1807.            NIBBLES.BAS  is in: C:\SYSTEM\
  1808.            REMLINE.BAS  is in: C:\SYSTEM\
  1809.            ASSIGN.COM   is in: C:\SYSTEM\
  1810.            COMMAND.COM  is in: C:\SYSTEM\
  1811.       Note: Possible duplicate file names are listed with the original      Note: Possible duplicate file names are listed with the original
  1812.       location!      location!
  1813.  
  1814.       -------------------- EDITED -------------------------------
  1815.               83 files found.
  1816.               83 possible duplicate files.
  1817.                0 files added to FIDX.
  1818.  
  1819.       -------------------- EDITED -------------------------------
  1820.       Directory: C:\TP\DEMOS\TCALC\                              ****
  1821.       Note: Indicates no LIDX.DEF record generated               ^^^^      Note: Indicates no LIDX.DEF record generated               ^^^^
  1822.  
  1823.       -------------------- EDITED -------------------------------
  1824.       New LIDX file has 257 records
  1825.             3760 files found.
  1826.              392 possible duplicate files.
  1827.             3368 files added to FIDX.
  1828.  
  1829.       Note: TMakeFFS only reports duplicate file names it does test file      Note: TMakeFFS only reports duplicate file names it does test file
  1830.       date/time stamps, sizes or contents!      date/time stamps, sizes or contents!
  1831.  
  1832.       [FMS]
  1833.                     FMS FILE: G:\FMS.DIR
  1834.                  Record Size:         81
  1835.           Description Length:         43
  1836.  
  1837.            File is off-line => FIDX.TMP
  1838.            File is off-line => FIDXT.TMP
  1839.            File is off-line => FMS.TMP
  1840.            File is off-line => LIDX.TMP
  1841.                4 files offline
  1842.  
  1843.       Note: Files in FMS not found in specified directories      Note: Files in FMS not found in specified directories
  1844.  
  1845.       [FIDX]
  1846.            File not in FMS => C:\TP\UNITS\FIDX\FIDX.ORG
  1847.            File not in FMS => C:\TP\UNITS\FIDX\FIDXT.ORG
  1848.            File not in FMS => C:\TP\UNITS\FIDX\FMS.ORG
  1849.            File not in FMS => C:\TP\UNITS\FIDX\LIDX.ORG
  1850.             3372 records written,          4 files missing from FMS!
  1851.  
  1852.       Note: Files found in specified directories but missing from FMS      Note: Files found in specified directories but missing from FMS
  1853.       [END REPORT]
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.       (C) Copyright 1991, JONCO Systems and Software              28
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.                                     Appendix DAppendix D
  1870.  
  1871.                               Error Level Exit CodesError Level Exit Codes
  1872.  
  1873.  
  1874.            1  - Cannot Locate Init File [TMakeFFS.Ini]
  1875.                 TMakeFFS could not find the default init file or
  1876.                 the init file specified on the command line.
  1877.  
  1878.            2  - Invalid Init File
  1879.                 The default init file or the init file specified on
  1880.                 the command line is invalid.
  1881.                 (The first line is not [TFMS_SYSTEM])
  1882.  
  1883.            3  - Invalid/Unknown Command in Init File
  1884.                 Unable to parse the command in the init file.
  1885.                 Probably caused by a missing [;] preceding comment
  1886.                 text.
  1887.  
  1888.            4  - Missing required command LIDX=
  1889.                 LIDX file must be specified either in environment or
  1890.                 in Init file. Possible cause Init file contains NOENV
  1891.                 command and does not contain a
  1892.                 LIDX=Drive:\Path\FileName.Ext.
  1893.  
  1894.            5  - Missing required command FIDX=
  1895.                 FIDX file must be specified either in environment or
  1896.                 in Init file. Possible cause Init file contains NOENV
  1897.                 command and does not contain a
  1898.                 FIDX=Drive:\Path\FileName.Ext.
  1899.  
  1900.            6  - Insufficient memory to continue processing
  1901.                 Conventional memory (below 640K) full too many
  1902.                 subdirectories and/or files and EMS is either not
  1903.                 available or turned off. Make more memory available,
  1904.                 make EMS available or combine subdirectories.
  1905.  
  1906.            7  - Unable to reallocate or Insufficient EMS memory
  1907.                 If EMS 4.0 there are no more free pages available,
  1908.                 If EMS 3.2 there either wasn't enough EMS available
  1909.                 to begin with or command line option restricted the
  1910.                 maximum to low.
  1911.  
  1912.            8  - Out of memory resources
  1913.                 Insufficient conventional memory for temporary EMS
  1914.                 page lock record. Make more conventional memory
  1915.                 available or combine subdirectories and/or file
  1916.                 list macros. (Reducing size of environment by as
  1917.  
  1918.  
  1919.  
  1920.       (C) Copyright 1991, JONCO Systems and Software              29
  1921.  
  1922.  
  1923.                 little as 16 bytes might do the trick!)
  1924.  
  1925.            9+ - Unexpected unrecoverable error code XXX
  1926.                 I really don't think this can happen, it never has
  1927.                 to date! Could indicate a hardware failure though
  1928.                 (See following!)
  1929.  
  1930.       Possible DOS related error codes
  1931.  
  1932.            100- Disk Read Error
  1933.            101- Disk Write Error  (NOTE: TMakeFFS will first attempt
  1934.                                          to turn off Log File and erase
  1935.                                          it to free disk space before
  1936.                                          terminating with this error.)
  1937.            150- Disk is write protected
  1938.            151- Unknown Unit
  1939.            152- Drive not ready
  1940.            154- CRC error in data
  1941.            156- Disk Seek Error
  1942.            157- Unknown Media Type
  1943.            158- Sector not found
  1944.            160- Device write fault
  1945.            161- Device read fault
  1946.            162- Hardware failure
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.       (C) Copyright 1991, JONCO Systems and Software              30
  1981.